package com.huashi.dealer.modular.business.region.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.huashi.dealer.commonEntity.Region;
import com.huashi.dealer.modular.business.region.param.RegionListItemVo;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import org.springframework.stereotype.Component;

import java.util.List;

/**
 * 地域Mapper接口
 *
 * @author 系统生成
 * @since 2025-01-27
 */
@Mapper
@Component("regionMapper")
public interface RegionMapper extends BaseMapper<Region> {

    /**
     * 根据父级ID获取地域列表
     *
     * @param parentId 父级ID，0表示获取省份列表
     * @return 地域列表
     */
    List<RegionListItemVo> selectByParentId(@Param("parentId") Long parentId);

    /**
     * 根据ID获取地域名称
     *
     * @param regionId 地域ID
     * @return 地域名称
     */
    String selectNameById(@Param("regionId") Long regionId);

    /**
     * 根据名称和父级ID获取地域ID
     *
     * @param regionName 地域名称
     * @param parentId   父级ID
     * @return 地域ID
     */
    Long selectIdByNameAndParent(@Param("regionName") String regionName, @Param("parentId") Long parentId);

    /**
     * 获取所有省份列表
     *
     * @return 省份列表
     */
    List<RegionListItemVo> selectProvinces();

    /**
     * 获取指定省份下的城市列表
     *
     * @param provinceId 省份ID
     * @return 城市列表
     */
    List<RegionListItemVo> selectCitiesByProvince(@Param("provinceId") Long provinceId);

    /**
     * 获取指定城市下的区县列表
     *
     * @param cityId 城市ID
     * @return 区县列表
     */
    List<RegionListItemVo> selectRegionsByCity(@Param("cityId") Long cityId);
}
